Подготовка приложения

Перед подключением API создайте в Gigma Application — контекст конкретного сайта, приложения или сервиса. Это может быть интернет-магазин, мобильное приложение, личный кабинет, подписочный продукт или другой клиентский интерфейс.

Application определяет, какие настройки увидит клиентский интерфейс: каталог, склады, способы оплаты, контент, меню и подписочные тарифы. Сам интерфейс и его маршруты создаёт ваша команда.

Что нужно получить

Для запуска нужны:

ERP-доступ к нужному Project;
существующее или новое Application;
App Token этого приложения;
настроенные источники каталога и оплаты;
хотя бы один готовый пользовательский сценарий: каталог, заказ или подписка.

Для создания или изменения приложения у ERP-пользователя должно быть соответствующее право, например create-applications или edit-applications.

Что настроить в Gigma

Настройка	Для чего нужна
Категории, бренды и склады	определяют ассортимент и цены каталога
Способы доставки и оплаты	используются при создании обычного заказа
Подписочные тарифы	формируют каталог подписок конкретного приложения
Страницы, блоки и меню	позволяют менять контент без выпуска новой версии frontend
Уведомления и webhooks	сообщают клиенту и вашему backend о событиях

Каталог создаётся в Платформа / Номенклатура, контент — в Платформа / Страницы, настройки приложения — в Платформа / Приложения.

Как App Token участвует в запросе

Передавайте App Token в заголовке Token:

GET /api/counterparty/settings HTTP/1.1
Host: api.gigma.ru
Token: <application_token>
Accept: application/json

Успешный ответ подтверждает, что token распознан и контекст Application выбран:

{
    "wholesale": false
}

App Token выбирает приложение, но не идентифицирует клиента. Профиль работает по Counterparty Bearer; избранное, заказы и подписки требуют Counterparty Bearer вместе с App Token.

Порядок подключения

Создайте или выберите Application через ERP API приложений.
Сохраните App Token и не смешивайте его с ERP Bearer или Counterparty Bearer.
Настройте каталог, склады, оплату и доставку.
Для подписочного продукта назначьте активные тарифы текущему Application.
Добавьте страницы, блоки и меню, если контент должен управляться из Gigma.
Проверьте GET /api/counterparty/settings.
Получите каталог, тарифы и цены.
Подключите вход клиента.
Реализуйте заказ, оплату или подписку.

Как выбрать следующую страницу

Только публичная витрина: начните с каталога, тарифов и цен.
Нужен личный кабинет: подключите вход клиента и профиль.
Покупка товара: используйте заказы, оплаты и подписки и доставку, оплату и справочники.
Платный доступ к вашему сервису: сначала изучите интеграцию с backend.

Граница ответственности

Gigma хранит клиентские профили, каталог, заказы, оплаты и подписки. Ваш продукт отвечает за интерфейс, локальную сессию и собственные закрытые данные. Не считайте наличие кнопки «Оплачено» на frontend доказательством покупки: право доступа должно подтверждаться актуальным состоянием на backend.